home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 2 / MacMania 2.toast / Demo's / Tools&Utilities / System Utilities / MacGS 2.5.2ß3 Runtime ƒ / READ_ME < prev   
Encoding:
Text File  |  1994-02-15  |  9.5 KB  |  235 lines  |  [TEXT/KAHL]
  1. 17 April 1993
  2.  
  3. Overview
  4. --------
  5. MacGS_2.5.2b3_Runtime.cpt contains a self-contained runtime
  6. environment for version 2.5.2 Beta 3 of Macintosh Ghostscript that
  7. runs on a Macintosh with at least 2 Megabytes of memory.
  8.  
  9. MacGS_2.5.2b3_RT_No_Fonts.cpt is identical to
  10. MacGS_2.5.2b3_Runtime.cpt except it does *not* contain the Ghostscript
  11. fonts.  This file was specifically created for those who are upgrading
  12. from a previous version of MacGS 2.5.x and who wish to avoid the cost
  13. of transferring Ghostscript's fonts.  Please do *not* obtain this
  14. archive unless you are upgrading from a previous version of MacGS
  15. 2.5.x.
  16.  
  17. MacGS_2.5.2b3_Dev.cpt contains the development environment for version
  18. 2.5.2 Beta 3 of Macintosh Ghostscript.  Because it does *not* contain
  19. all of the Ghostscript fonts, you must also obtain and unarchive
  20. MacGS_2.5.2b3_Runtime.cpt to obtain a complete Ghostscript runtime
  21. environment.  However, this archive contains sufficient files to run
  22. standalone.
  23.  
  24. This implemention does *not* require 32-bit Color QuickDraw and runs
  25. under both System 6 and System 7.  It should even run on black-and-
  26. white displays.
  27.  
  28. One version does *not* presuppose a 68020 or better processor, nor
  29. does it presuppose the existence of a 68881 FPU.  The FPU version
  30. (which is 20% faster) does *not* check that these hardware
  31. requirements have been satisfied.
  32.  
  33.  
  34. Getting Started
  35. ------- -------
  36. Once Ghostscript is initialized, use the MacGS menu item Open File...
  37. to select a file to preview.  I suggest your opening one of the files
  38. in gs:(Tests).  Also note that most of the files in the (macGS Tests)
  39. folder assume that the Laserprep file was previously loaded.  Use the
  40. MacGS menu item Resume to continue.
  41.  
  42. Because MacGS used hardcoded relative paths, I *strongly* suggest that
  43. you neither rename nor move files contained within the MacGS folder.
  44. If you do, you risk of having MacGS fail during initialization and
  45. prematurely terminating.
  46.  
  47.  
  48. Mac-Specific Features
  49. ------------ --------
  50. Once Ghostscript is initialized, you can open and display PostScript
  51. files via the MacGS menu.  This menu also allows you to save your
  52. PostScript output as a PICT file.
  53.  
  54. You can Cut and Copy the rendered image to the clipboard.
  55.  
  56. The arrow keys will scroll the graphics window.  On an extended
  57. keyboard, the Page Up/Down and Home/End keys will scroll the image
  58. appropriately; the addition of the Option key alternatively specifies
  59. the horizontal scrollbar.
  60.  
  61.  
  62. Beta 3 Enhancements and Bug Fixes
  63. ---- - ------------ --- --- -----
  64. Because MacGS now correctly responds to page size and resolution
  65. changes specified via the GS' putdeviceprops operator (see
  66. language.doc), it will also change the size of its displayable area to
  67. match the paper sizes specified in gs_statd.ps.  Also, the file
  68. 300dpi.ps, located in (macGS Tests), shows how to change the displayed
  69. output resolution to 300 dpi.
  70.  
  71. MacGS will open PS files of type 'EPSF' as well as those of type
  72. 'TEXT'.
  73.  
  74.  
  75. Beta 2 Enhancements
  76. ---- - ------------
  77. The MacGS menu is now immediately available without having to bring
  78. the Graphics Window frontmost.  The command-key equivalents of the
  79. MacGS menu items are also honored.  (This entailed selectively
  80. pre-empting THINK C's console driver *without* changing any of
  81. Symantec's code.)  As there have been reports of menu problems with
  82. Beta 1, these changes may ameliorate those problems.
  83.  
  84. You may now select alternative device drivers via MacGS' Configure...
  85. menu item.  In the near future (RSN :-), I'll look into providing a
  86. GUI to allow you to specify device-specific attributes.  Please note
  87. that most of the other drivers (viz., GIF and PBMPlus) create scratch
  88. files, some which need to be deleted and others which need to be
  89. renamed.  However, this behavior seems to be a consequence of how
  90. these drivers were originally implemented.
  91.  
  92. You may interactively select a region to save to a file or copy to the
  93. clipboard.  Although this feature has been successfully tested with
  94. escher.ps, tiger.ps, and golfer.ps with a 2 Mbyte memory partition,
  95. depending upon the complexity of your image, you may need to increase
  96. MacGS' memory size.
  97.  
  98. When MacGS is rendering via the Open File... menu item, the cursor is
  99. changed to a spinning watch.
  100.  
  101. Under System 7, background processes are now given cycles.
  102.  
  103. showpage always requires the use of MacGS' Resume menu item.
  104.  
  105. If PICT recording runs out of memory, MacGS returns VMError.
  106.  
  107. To accommodate MacGS and intialization file interdependencies,
  108. gs_mac.ps checks MacGS' version.
  109.  
  110.  
  111. Beta 1 Enhancements and Bug Fixes
  112. ---- - ------------ --- --- -----
  113. You may now interrupt the execution of a large PS file by invoking
  114. Stop from the MacGS menu when GS pauses at the end of a page after a
  115. showpage.
  116.  
  117. The name of the Laserprep file has been moved from MacGS' resource
  118. file to the gs_mac.ps initialization file.
  119.  
  120. Runtime errors sometimes caused MacGS to terminate abnormally with a
  121. typecheck error if the Ghostscript interpretor was implicitly invoked
  122. via the Open File... menu item (-- matmesh2.ps did this).  This was
  123. caused by PS programs which did not restore the operand and dictionary
  124. stacks to their previous non-empty states.  The .macrunfile procedure
  125. in gs_mac.ps has been modified to accommodate this ... *antisocial*
  126. behavior.
  127.  
  128. In Beta zero, the Open File... command did not work the very first
  129. time it was used.
  130.  
  131.  
  132. Limitations (Caveat emptor!)
  133. ----------- ------- --------
  134. Both BeHierarchic and MenuChoice conflict with MacGS.  Because most of
  135. MacGS' GUI is implemented as a device driver, and because both of
  136. these INITs patch menu-related traps and don't necessarily restore the
  137. current resource file context, I strongly suggest that you not install
  138. these INITs when running MacGS.  (For you Mac hackers, the reason that
  139. MacGS' GUI is implemented as a device driver is because THINK C's
  140. *unmodified* stdio routines are implicitly running MacGS' event loop
  141. -- talk about tails wagging dogs!  Thus, MacGS is *unable* to save and
  142. restore the resource file context because it *never* calls MenuSelect
  143. ().)
  144.  
  145. There is no way to gracefully interrupt MacGS while it is rendering.
  146. Although I've implemented preliminary code (-- MacGS actually detects
  147. Command-. key presses), this feature relies on GS using the return
  148. value from gp_check_interrupts ().  Peter says that this is on his
  149. list of things to fix for GS 2.6.
  150.  
  151. MacGS 2.5.2 is *absymally* slow when rendering snowflak.ps.  This is
  152. because Peter eliminated the use of driver-specific fill trapezoid
  153. routines.  (MacGS *2.2* is actually very much faster.  Oh, well -- one
  154. step forward, two steps back....)  Peter's suggestion is to create an
  155. image device and let Ghostscript do the rendering.  However, the
  156. tradeoff is that a resultant picture is comprised of a monolithic
  157. bitmap and not composite, and editable, QD picture elements.
  158.  
  159. Printing appears to work for LaserWriters and DeskWriters.  However,
  160. because MacGS is printing a backing-store QD picture, the resolution
  161. is limited to 72 dpi (the Macintosh screen density).  In order to
  162. accommodate laserprinter resolutions (e.g., 300 dpi or whatever),
  163. MacGS would need to re-render the image at a higher resolution.  This
  164. is better done with a dedicated (TBD) MacGS printer driver.
  165.  
  166.  
  167. Bugs
  168. ----
  169. On a black-and-white (viz., 1-bit deep) display, some PS files make
  170. the initial contents of the graphics window black; scrolling the
  171. window sometimes ameliorates this problem.
  172.  
  173. There is a problem with GS 2.5.2 (which MacGS inherits) rendering
  174. screen.ps.  Peter is fixing this in GS 2.6.
  175.  
  176. There have been reports of INIT/cdev conflicts (Menubar Pattern,
  177. Window Shade, MenuChoice, and BeHierarchic).  If you suspect that
  178. MacGS is failing because of an INIT conflict, please drop me a note
  179. indicating the suspect extension.  If the extension is either freeware
  180. or shareware, please indicate its availability and I'll attempt to
  181. obtain a copy for testing.
  182.  
  183. MacGS appears to suffer from memory lossage.  Symptoms include partial
  184. rendering to the screen, lack of backing-store, etc..  If this occurs,
  185. quit and restart MacGS.  If this problem persists, increase MacGS'
  186. memory size.  If it still persists, please drop me a note.
  187.  
  188.  
  189. THINK C Configuration Issues
  190. ----- - ------------- ------
  191. Because THINK C's development environment only approximates a unix
  192. system, you need to create an empty file named "sys/types.h" and put
  193. it in THINK C's system header file path (viz., where THINK C searches
  194. for "<.h>" files).  In addition, you'll need to create an alias (-- or
  195. a copy, for those of you still using System 6) of stdlib.h named
  196. "malloc.h" and also put it in THINK C's system header file path.
  197.  
  198.  
  199. Resource Hacking
  200. -------- -------
  201. I've created a 'pref' resource (the associated TMPL resource is
  202. included) that defines the size of the graphics output window.  If you
  203. want MacGS to use something other than your screen's maximum size,
  204. select the "Use resource" flag and change the resource's width and
  205. height fields.  Also, if you're both adventurous and curious, this
  206. resource contains additional fields whose values you may change for
  207. your runtime enjoyment.
  208.  
  209. You may also change MacGS' default paths by modifying the first string
  210. in the STR# 128 resource.  Caveat emptor!
  211.  
  212.  
  213. Potential Futures
  214. --------- -------
  215. An automatic printing driver.
  216.  
  217. Perhaps someone will be adventurous and create a PostScript-to-EPS
  218. driver using MacGS as a starting point.  :-)
  219.  
  220. Drag and drop preview/printing.
  221.  
  222. PAP level printing to PS printers.  Issues include what to do about
  223. missing fonts.
  224.  
  225.  
  226. Distribution Caveats
  227. ------------ -------
  228. Even though I've not necessarily included the caveat in all of MacGS'
  229. source code, the distribution of the source code is controlled by the
  230. GNU General License.
  231.  
  232.  
  233. ...Martin Fong                mwfong@nisc.sri.com
  234.  
  235.